COMO FAZER A DEPURAÇÃO SEM FIO DE APLICATIVOS ANDROID NO DELPHI

Configure a depuração sem fio no Delphi com este guia prático e resolva erros comuns para otimizar seu desenvolvimento mobile. A depuração sem fio é uma ferramenta essencial para desenvolvedores que buscam mais liberdade e praticidade ao testar aplicativos Android no Delphi (RAD Studio). Neste tutorial, você aprenderá o passo a passo detalhado para configurar a depuração sem fio, conectar seu dispositivo Android ao Delphi e evitar os erros mais comuns. Desenvolvido pela Max Suport Sistemas, especialista em soluções para desenvolvimento e gestão de negócios.

Ativando a Opção de Desenvolvedor no Android

Antes de começar, é necessário habilitar as Opções de Desenvolvedor no seu dispositivo Android:

  1. Acesse Configurações > Sobre o telefone.
  2. Toque 7 vezes em Número da versão até ativar o modo desenvolvedor.
  3. Volte para Configurações > Sistema > Opções do desenvolvedor.

Ativando Depuração USB e Sem Fio

Com as Opções de Desenvolvedor ativadas, siga os passos:

  1. Ative a Depuração USB.
  2. Ative a Depuração sem fio.

Atenção: Apenas ativar a Depuração Sem Fio não é suficiente. É necessário fazer uma conexão inicial via cabo USB ou emparelhar via código.

Primeira Conexão com Cabo USB

Para a configuração inicial:

  1. Conecte o celular ao computador com um cabo USB.
  2. Aceite a solicitação de Permitir Depuração USB no celular.
  3. Marque Permitir sempre para este computador para evitar avisos futuros.

Emparelhamento via Código

Agora, vamos emparelhar o dispositivo:

  1. No celular, em Depuração sem fio, clique em Emparelhar dispositivo via código de emparelhamento.
  2. Um IP, uma porta e um código de 6 dígitos serão exibidos.
  3. No terminal, navegue até a pasta das ferramentas do Android (exemplo: C:\Users\Public\Documents\Embarcadero\Studio\22.0\CatalogRepository\AndroidSDK\platform-tools) e execute:
.\adb.exe pair IP:PORTA

Exemplo:

.\adb.exe pair 192.168.10.60:38751

Digite o código de 6 dígitos mostrado no celular. Se bem-sucedido, o terminal exibirá:

Successfully paired to 192.168.10.60:38751

Conectando o Dispositivo

Após o emparelhamento, conecte o dispositivo:

.\adb.exe connect IP:PORTA

Exemplo:

                    .\adb.exe connect 192.168.10.60:47831

Nota: A porta de conexão pode ser diferente da porta de emparelhamento. Verifique o IP e a porta na tela de Depuração Sem Fio.

Se a conexão for bem-sucedida, você verá:

connected to 192.168.10.60:47831

Confirmando a Conexão

Verifique os dispositivos conectados:

                    .\adb.exe devices

O dispositivo deve aparecer listado, como:

                    List of devices attached
                    192.168.10.60:47831 device

Configurando no Delphi

Com a conexão estabelecida:

  1. No Gerenciador de Dispositivos do Delphi, seu dispositivo Android deve aparecer.
  2. Selecione-o como destino.
  3. Compile e execute o projeto normalmente.

Erros Comuns e Soluções

Enfrentou problemas? Veja as soluções para os erros mais frequentes:

  • Erro: unknown command IP:PORTA
    Solução: Use pair em vez de connect.
  • Erro: cannot connect to IP:PORTA: (10061)
    Solução: Verifique se o celular está pronto e se o IP/porta estão corretos.
  • Erro: Project.apk raised exception class EFCreateError
    Solução: Use TPath.GetDocumentsPath para evitar pastas protegidas no Android.
  • Dispositivo não aparece no Delphi
    Solução: Confirme se adb.exe devices lista o celular. Repita a conexão, se necessário.

Considerações Finais

A depuração sem fio no Delphi oferece liberdade e praticidade, eliminando a dependência de cabos USB e problemas de mau contato. Com este tutorial, você pode:

  • Depurar aplicativos Android sem cabos.
  • Trabalhar com mais mobilidade.
  • Evitar erros comuns com soluções práticas.

Se gostou deste tutorial, compartilhe! 🚀

28/04/2025 - Por Max Suport Sistemas